Accessing Multi-Instance Data

The values of Attributes in multi-instance Dialogs are automatically mapped to and from the values of the "current sub-dialog instance" (i.e. the Sub-dialog being displayed by Add or Edit). Therefore all Decision Trees & Procedures triggered from a Sub-dialog will automatically reference Attribute values from its current instance data.

Data can also be accessed, via procedure commands, using the full instance reference.

For example:

@Debug MainDialog.SubDialog1[1].Name

@Debug MainDialog.SubDialog1[1].Age

There are also read-only properties which can be accessed

count (the number instances)
- e.g. @Debug MainDialog.SubDialog1.count

current (the current instance number)
- e.g. @Debug MainDialog.SubDialog1.current

There is also a 'clear' method which can be used to delete all in instances of a sub dialog.

e.g. @Do MainDialog.SubDialog1.clear

There are two special commands which can be used in conjunction with multi-instance Dialogs

@EncodeDialogXML <xml output string>,<dialog>
@DecodeDialogXML <xml imput string>

For example:

@EncodeDialogXML DataStr,Dialog1

Where DataStr is a String Variable (or Text Object) and is used to hold an xml representation of all the currently stored instance data (on Dialog1 and all its sub dialogs)

@DecodeDialogXML DataStr

This would populate the xml data in DataStr into the relevant Objects on a Dialog & its Sub-Dialogs. This would be in addition to any existing instances (use the above 'clear' method if you wish to replace existing instances before populating)